SAVEPOINT Function
 ----------------------------------------------------------------------------


 Action

 Marks the beginning of a subset of ISAM database operations in a
 transaction.


 Syntax



  SAVEPOINT

 Remarks


 The  SAVEPOINT function marks the beginning of a subset of operations within
 a transaction that can be rescinded using a  ROLLBACK statement. The
 function returns an integer that refers to the savepoint.

 Transactions are a way to group a series of ISAM operations so that you can
 commit them as a whole, rescind them all, or rescind operations since a
 designated savepoint. Use  BEGINTRANS to indicate the beginning of a
 transaction and  COMMITTRANS to commit all operations since the beginning of
 a transaction.

 Use  ROLLBACK with the argument  savepoint% to return the data affected by a
 transaction to its state at that savepoint. Use  ROLLBACK with no argument
 to return the data affected by the transaction to its state at the most
 recent savepoint, or at the beginning of the transaction if there are no
 intermediate savepoints.

  ROLLBACK ALL rescinds all ISAM operations in a transaction and returns the
 data to its initial state at the beginning of the transaction.

 If there is no transaction pending when you use  SAVEPOINT, BASIC generates
 the error message Illegal function call.


 See Also

  BEGINTRANS,  COMMITTRANS,  ROLLBACK


 Example

 See the  BEGINTRANS statement programming example, which uses the  SAVEPOINT
 function.